Summary

Generated AWS clients are async, but they're named <SdkId>Client (e.g. BedrockRuntimeClient). This PR renames them to Async<SdkId>Client (e.g. AsyncBedrockRuntimeClient) to match the convention and to free up the unprefixed name for the sync clients we plan to add later.

The rename is a breaking change for the clients already published under the old name. To keep existing code working, those clients also emit the old name as a deprecated alias that resolves to the async client and raises a DeprecationWarning. The alias is temporary and will be removed in a minor bump sometime in the future.

Scope

The Async rename applies to all generated AWS clients. The backwards-compat alias is only generated for the clients already published under the unprefixed name in awslabs/aws-sdk-python:

Bedrock Runtime, ConnectHealth, Lex Runtime V2, Polly, QBusiness, SageMaker Runtime HTTP2, Transcribe Streaming

New clients released after this change is merged are created with the Async-prefixed and no alias.

Before

Client Class:

class BedrockRuntimeClient
    ...

Usage (no warning):

>>> from aws_sdk_bedrock_runtime.client import BedrockRuntimeClient
>>> BedrockRuntimeClient()
<aws_sdk_bedrock_runtime.client.AsyncBedrockRuntimeClient object at 0x102ce64e0>

After

The old name stays importable at runtime (with a DeprecationWarning) and resolves for type checkers via the TYPE_CHECKING alias.

Client Class:

class AsyncBedrockRuntimeClient
    ...

if TYPE_CHECKING:
    # Deprecated alias for backwards compatibility, to be removed.
    BedrockRuntimeClient = AsyncBedrockRuntimeClient

def __getattr__(name: str) -> Any:
    if name == "BedrockRuntimeClient":
        warnings.warn(
            "BedrockRuntimeClient is deprecated, use AsyncBedrockRuntimeClient instead. "
            "This alias will be removed in a future version.",
            DeprecationWarning,
            stacklevel=2,
        )
        return AsyncBedrockRuntimeClient
    raise AttributeError(f"module {__name__!r} has no attribute {name!r}")

Usage:

>>> from aws_sdk_bedrock_runtime.client import AsyncBedrockRuntimeClient
>>> AsyncBedrockRuntimeClient()
<aws_sdk_bedrock_runtime.client.AsyncBedrockRuntimeClient object at 0x102ce7530>
>>> from aws_sdk_bedrock_runtime.client import BedrockRuntimeClient
<stdin>:1: DeprecationWarning: BedrockRuntimeClient is deprecated, use AsyncBedrockRuntimeClient instead. This alias will be removed in a future version.
>>> BedrockRuntimeClient()
<aws_sdk_bedrock_runtime.client.AsyncBedrockRuntimeClient object at 0x102ce64e0>

A newly added service (not in the allowlist) generates just the class, no alias:

class AsyncWeatherClient:
    ...

Backwards compatibility

Existing customer code using BedrockRuntimeClient will continue to work since we're aliasing it to AsyncBedrockRuntimeClient. This will be removed in a future version of the SDK in a minor bump before GA.

Testing

Regenerated all 7 aws-sdk-python clients. I verified all clients have the renamed class and only the existing clients get the aliasing logic.

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.